Autogenerated HTML docs for v2.2.0-rc0
diff --git a/technical/api-gitattributes.html b/technical/api-gitattributes.html index 33e592f..bb37360 100644 --- a/technical/api-gitattributes.html +++ b/technical/api-gitattributes.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 8.6.6" /> +<meta name="generator" content="AsciiDoc 8.6.9" /> <title>gitattributes API</title> <style type="text/css"> /* Shared CSS for AsciiDoc xhtml11 and html5 backends */ @@ -87,10 +87,16 @@ ul > li { color: #aaa; } ul > li > * { color: black; } -pre { +.monospaced, code, pre { + font-family: "Courier New", Courier, monospace; + font-size: inherit; + color: navy; padding: 0; margin: 0; } +pre { + white-space: pre-wrap; +} #author { color: #527bbd; @@ -219,7 +225,7 @@ } div.imageblock div.content { padding-left: 0; } -span.image img { border-style: none; } +span.image img { border-style: none; vertical-align: text-bottom; } a.image:visited { color: white; } dl { @@ -349,7 +355,7 @@ margin-bottom: 0.1em; } -div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { +div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { margin-top: 0; margin-bottom: 0; } @@ -407,18 +413,14 @@ span.overline { text-decoration: overline; } span.line-through { text-decoration: line-through; } +div.unbreakable { page-break-inside: avoid; } + /* * xhtml11 specific * * */ -tt { - font-family: monospace; - font-size: inherit; - color: navy; -} - div.tableblock { margin-top: 1.0em; margin-bottom: 1.5em; @@ -452,12 +454,6 @@ * * */ -.monospaced { - font-family: monospace; - font-size: inherit; - color: navy; -} - table.tableblock { margin-top: 1.0em; margin-bottom: 1.5em; @@ -537,6 +533,8 @@ @media print { body.manpage div#toc { display: none; } } + + </style> <script type="text/javascript"> /*<+'])'); + var re = new RegExp('[hH]([1-'+(toclevels+1)+'])'); // Function that scans the DOM tree for header elements (the DOM2 // nodeIterator API would be a better technique but not supported by all // browsers). @@ -610,7 +608,7 @@ var i; for (i = 0; i < toc.childNodes.length; i++) { var entry = toc.childNodes[i]; - if (entry.nodeName == 'div' + if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") && entry.getAttribute("class").match(/^toclevel/)) tocEntriesToRemove.push(entry); @@ -656,7 +654,7 @@ var entriesToRemove = []; for (i = 0; i < noteholder.childNodes.length; i++) { var entry = noteholder.childNodes[i]; - if (entry.nodeName == 'div' && entry.getAttribute("class") == "footnote") + if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote") entriesToRemove.push(entry); } for (i = 0; i < entriesToRemove.length; i++) { @@ -749,24 +747,24 @@ <div class="sectionbody"> <div class="dlist"><dl> <dt class="hdlist1"> -<tt>struct git_attr</tt> +<code>struct git_attr</code> </dt> <dd> <p> An attribute is an opaque object that is identified by its name. - Pass the name to <tt>git_attr()</tt> function to obtain the object of + Pass the name to <code>git_attr()</code> function to obtain the object of this type. The internal representation of this structure is of no interest to the calling programs. The name of the - attribute can be retrieved by calling <tt>git_attr_name()</tt>. + attribute can be retrieved by calling <code>git_attr_name()</code>. </p> </dd> <dt class="hdlist1"> -<tt>struct git_attr_check</tt> +<code>struct git_attr_check</code> </dt> <dd> <p> This structure represents a set of attributes to check in a call - to <tt>git_check_attr()</tt> function, and receives the results. + to <code>git_check_attr()</code> function, and receives the results. </p> </dd> </dl></div> @@ -776,11 +774,11 @@ <h2 id="_attribute_values">Attribute Values</h2> <div class="sectionbody"> <div class="paragraph"><p>An attribute for a path can be in one of four states: Set, Unset, -Unspecified or set to a string, and <tt>.value</tt> member of <tt>struct -git_attr_check</tt> records it. There are three macros to check these:</p></div> +Unspecified or set to a string, and <code>.value</code> member of <code>struct +git_attr_check</code> records it. There are three macros to check these:</p></div> <div class="dlist"><dl> <dt class="hdlist1"> -<tt>ATTR_TRUE()</tt> +<code>ATTR_TRUE()</code> </dt> <dd> <p> @@ -788,7 +786,7 @@ </p> </dd> <dt class="hdlist1"> -<tt>ATTR_FALSE()</tt> +<code>ATTR_FALSE()</code> </dt> <dd> <p> @@ -796,7 +794,7 @@ </p> </dd> <dt class="hdlist1"> -<tt>ATTR_UNSET()</tt> +<code>ATTR_UNSET()</code> </dt> <dd> <p> @@ -804,7 +802,7 @@ </p> </dd> </dl></div> -<div class="paragraph"><p>If none of the above returns true, <tt>.value</tt> member points at a string +<div class="paragraph"><p>If none of the above returns true, <code>.value</code> member points at a string value of the attribute for the path.</p></div> </div> </div> @@ -814,19 +812,19 @@ <div class="ulist"><ul> <li> <p> -Prepare an array of <tt>struct git_attr_check</tt> to define the list of +Prepare an array of <code>struct git_attr_check</code> to define the list of attributes you would want to check. To populate this array, you would - need to define necessary attributes by calling <tt>git_attr()</tt> function. + need to define necessary attributes by calling <code>git_attr()</code> function. </p> </li> <li> <p> -Call <tt>git_check_attr()</tt> to check the attributes for the path. +Call <code>git_check_attr()</code> to check the attributes for the path. </p> </li> <li> <p> -Inspect <tt>git_attr_check</tt> structure to see how each of the attribute in +Inspect <code>git_attr_check</code> structure to see how each of the attribute in the array is defined for the path. </p> </li> @@ -840,47 +838,47 @@ <div class="olist arabic"><ol class="arabic"> <li> <p> -Prepare an array of <tt>struct git_attr_check</tt> with two elements (because - we are checking two attributes). Initialize their <tt>attr</tt> member with - pointers to <tt>struct git_attr</tt> obtained by calling <tt>git_attr()</tt>: +Prepare an array of <code>struct git_attr_check</code> with two elements (because + we are checking two attributes). Initialize their <code>attr</code> member with + pointers to <code>struct git_attr</code> obtained by calling <code>git_attr()</code>: </p> </li> </ol></div> <div class="listingblock"> <div class="content"> -<pre><tt>static struct git_attr_check check[2]; +<pre><code>static struct git_attr_check check[2]; static void setup_check(void) { if (check[0].attr) return; /* already done */ check[0].attr = git_attr("crlf"); check[1].attr = git_attr("ident"); -}</tt></pre> +}</code></pre> </div></div> <div class="olist arabic"><ol class="arabic"> <li> <p> -Call <tt>git_check_attr()</tt> with the prepared array of <tt>struct git_attr_check</tt>: +Call <code>git_check_attr()</code> with the prepared array of <code>struct git_attr_check</code>: </p> </li> </ol></div> <div class="listingblock"> <div class="content"> -<pre><tt> const char *path; +<pre><code> const char *path; setup_check(); - git_check_attr(path, ARRAY_SIZE(check), check);</tt></pre> + git_check_attr(path, ARRAY_SIZE(check), check);</code></pre> </div></div> <div class="olist arabic"><ol class="arabic"> <li> <p> -Act on <tt>.value</tt> member of the result, left in <tt>check[]</tt>: +Act on <code>.value</code> member of the result, left in <code>check[]</code>: </p> </li> </ol></div> <div class="listingblock"> <div class="content"> -<pre><tt> const char *value = check[0].value; +<pre><code> const char *value = check[0].value; if (ATTR_TRUE(value)) { The attribute is Set, by listing only the name of the @@ -896,7 +894,7 @@ file for the path by saying "attr=value". } else if (... other check using value as string ...) { ... - }</tt></pre> + }</code></pre> </div></div> </div> </div> @@ -907,23 +905,23 @@ <div class="ulist"><ul> <li> <p> -Call <tt>git_all_attrs()</tt>, which returns an array of <tt>git_attr_check</tt> +Call <code>git_all_attrs()</code>, which returns an array of <code>git_attr_check</code> structures. </p> </li> <li> <p> -Iterate over the <tt>git_attr_check</tt> array to examine the attribute +Iterate over the <code>git_attr_check</code> array to examine the attribute names and values. The name of the attribute described by a - <tt>git_attr_check</tt> object can be retrieved via - <tt>git_attr_name(check[i].attr)</tt>. (Please note that no items will be - returned for unset attributes, so <tt>ATTR_UNSET()</tt> will return false - for all returned <tt>git_array_check</tt> objects.) + <code>git_attr_check</code> object can be retrieved via + <code>git_attr_name(check[i].attr)</code>. (Please note that no items will be + returned for unset attributes, so <code>ATTR_UNSET()</code> will return false + for all returned <code>git_array_check</code> objects.) </p> </li> <li> <p> -Free the <tt>git_array_check</tt> array. +Free the <code>git_array_check</code> array. </p> </li> </ul></div> 